SftTabs/NET 6.0

ImageDisabled Property, ButtonsClass Class

Softel vdm, Inc.

Defines the Close, Minimize and Restore button image for a disabled button.

Syntax      ButtonsClass Class (Softelvdm.SftTabsNET)

VB   

Public Property ImageDisabled As Image

C#   

public Image ImageDisabled { get; set; }

C++   

public: property Image^ ImageDisabled {
        Image^ get();
        void set(Image^ value);
}

Property Value

An image containing representations of the Close, Minimize and Restore button graphic or null/Nothing to restore the default image.

The default value is null/Nothing.

Comments

The ImageDisabled property defines the Close, Minimize and Restore button image for a disabled button.

The ImageDisabled property can be used to override the default Close, Minimize and Restore button graphics provided by the tab control.

The image must contain three equal-sized images of the Close, Minimize and Restore button. The first third of the image is used for the Minimize button, the second third for the Restore button and the last third for the Close button.

The button graphics are arranged horizontally in the image, so the height of the image is the height of one button graphic and the width of the image is three times the width of one button graphic. The above sample contains 3 images (7 x 10 pixels).

If the Close, Minimize or Restore button is enabled, the image defined using the Image property is used instead of this property. If ImageDisabled does not define an image, the image defined using the Image property is painted in a "grayed" fashion".

The ImageDisabled property can be set to the value null/Nothing, which restores the tab control's default, built-in Close, Minimize and Restore button graphics.

The height of the Close, Minimize and Restore buttons and tabs is adjusted if necessary so the complete button graphic can be displayed vertically and horizontally. If the FullSize property is set to True, the Close, Minimize and Restore buttons are made as square as possible.

Sample button images can be found in the product directory \Program Files\Softelvdm\SftTabs NET 6.0\Images.

The Scrolling.ImageDisabled property can be used to define the scroll button graphics.


Feedback / comments / error reports for this topic
© 2007 - Softel vdm, Inc. - www.softelvdm.com